home *** CD-ROM | disk | FTP | other *** search
/ Precision Software Appli…tions Silver Collection 3 / Precision Software Applications Silver Collection Volume Three (PSM) (1993).iso / music2 / vthing11.arj / VT.DOC < prev    next >
Text File  |  1992-11-22  |  15KB  |  378 lines
  1.  
  2.  
  3.  
  4.                                    VOC THING
  5.                                   -=-=-=-=-=-
  6.              Copyright (c) 1992 Melvin Douglas All Rights Reserved
  7.                    Player/Recorder for VOC Format Sound Files
  8.                                 for use with a
  9.                            Sound Blaster Sound Card
  10.                           Version 1.1 December 1992
  11.                                   Shareware
  12.                               FAX (516)-533-2633
  13.  
  14.  
  15. Purpose: PLAYS and RECORDS VOC (Voice) Sound Files for Sound Blaster Owners.
  16.  
  17.  
  18. -----------
  19. LEGAL STUFF:
  20. -----------
  21.  
  22.     VOC THING software is hereafter referred to as VOC THING or VT.
  23.  
  24.     Users of VT must accept this disclaimer of warranty:
  25.  
  26.     "VOC THING IS  SUPPLIED AS IS.   THE AUTHOR DISCLAIMS  ALL  WARRANTIES,
  27.     EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION,  THE WARRANTIES OF
  28.     MERCHANTABILITY AND OF FITNESS FOR ANY PURPOSE.   THE AUTHOR ASSUMES NO
  29.     LIABILITY FOR DAMAGES,  DIRECT OR CONSEQUENTIAL,  WHICH MAY RESULT FROM
  30.     THE USE OF VOC THING."
  31.  
  32.     VT IS A "SHAREWARE PROGRAM"  AND IS PROVIDED AT NO CHARGE TO  THE
  33.     USER  FOR EVALUATION.   FEEL FREE TO SHARE IT WITH YOUR  FRIENDS, BUT
  34.     PLEASE DO NOT GIVE IT AWAY ALTERED OR AS PART OF ANOTHER SYSTEM.    THE
  35.     ESSENCE  OF "USER-SUPPORTED"  SOFTWARE IS TO PROVIDE PERSONAL  COMPUTER
  36.     USERS  WITH QUALITY SOFTWARE WITHOUT HIGH PRICES,  AND YET  TO  PROVIDE
  37.     INCENTIVE FOR PROGRAMMERS TO CONTINUE TO DEVELOP NEW PRODUCTS.   IF YOU
  38.     FIND  THIS  PROGRAM  USEFUL AND FIND THAT YOU ARE  USING  VOC THING AND
  39.     CONTINUE TO USE VOC THING AFTER A 21 DAY TRIAL PERIOD, YOU MUST MAKE  A
  40.     REGISTRATION PAYMENT OF $9.00 U.S DOLLARS.
  41.  
  42.     REGISTERED USERS WILL RECEIVE A FREE DISK OF VARIOUS VOC FILES TO PLAY.
  43.  
  44.        To register this copy, print and complete the REGISTER.FRM file
  45.        and send it along with the registration fee of $9 directly to:
  46.  
  47.                            Melvin Douglas
  48.                            Post Office Box 141
  49.                            Uniondale, New York
  50.                            11553-0141
  51.  
  52.     Sound Blaster is a registered trademark of Creative Labs Inc.
  53.     QuickBasic is a registered trademark of Microsoft Corp.
  54.  
  55.                PROGRAM FILES:
  56.                -------------
  57.                VT.EXE        - Voc Thing program
  58.                VT.DOC        - Voc Thing documentation
  59.                REGISTER.FRM  - Registration form
  60.                FILE_ID.DIZ   - BBS file description text
  61.                VENDOR.DOC    - Vendor distribution agreement
  62.                *.VOC         - several VOC files
  63.  
  64. In  case you don't read any further,  note that you may use any key on  the
  65. command  line  as a switch to bypass the opening screen:  i.e.,   "VT X".
  66. Additionally, you may type "VT REC" on to go directly to RECORD MODE.
  67.  
  68. ---------------------
  69. HARDWARE REQUIREMENTS:
  70. ---------------------
  71.  
  72.     o  An IBM PC/XT/AT/386/486 or true "compatible" running
  73.        MS-DOS or PC-DOS 3.0 or later.
  74.  
  75.     o  528K System Memory.
  76.  
  77.     o  CGA/EGA/VGA Video Adaptor.
  78.  
  79.     o  One floppy disk drive or hard drive.
  80.  
  81.     o  A Sound Blaster Sound board.
  82.  
  83.     o  A Microphone for recording.
  84.  
  85.     NOTE: No "drivers" are required to run VT.
  86.  
  87.  
  88.   Active Play/Record Controls are as follows:
  89.   -----------------------------------
  90.  
  91.   -  Pause sound.
  92.   -  Continue sound from a paused state.
  93.   -  Skip the current sound (immediate).
  94.   -  Cancel sound play mode and return to the Main Menu.
  95.   -  Cancel sound play mode and return to the File Selection Window.
  96.   -  Record up to a 10 second sound file.
  97.   -  Review a recorded sound file.
  98.   -  Save or Load a Play Session.
  99.   -  Save and Play your own voice files
  100.  
  101. --------------------
  102. COMMAND LINE OPTIONS:
  103. --------------------
  104.  
  105. As mentioned earlier, any single alphanumeric character on the command line
  106. will allow you to bypass the opening screen ie.,  "vt z", where "z" may be
  107. any printable letter or number.  Type "vt rec" to access the Record Mode.
  108.  
  109. ---------------------
  110. FILE SELECTION WINDOW:
  111. ---------------------
  112.  
  113. You may invoke the File Selection Window by typing ALT-V.  A listing of
  114. VOC files will be displayed if they are present in the current directory.
  115.  
  116. -----------------------
  117. FILE SELECTION COMMANDS: ALT-V  Activate File Window
  118. -----------------------
  119.  
  120. NOTE:  YOU MUST "TAG" A FILE IN ORDER TO PLAY IT UNLESS YOU ARE PLAYING A
  121. SINGLE SELECTION FROM THE COMMAND LINE.
  122.  
  123. Tag  one file at a time by pressing the  RIGHT ARROW key, or <Shift> RIGHT
  124. ARROW key.   Unshifted,  the highlighted bar will move down one file  after
  125. each tag.   Shifted,  it will move up one file.  Un-tag is exactly the same
  126. except using the LEFT ARROW key.
  127.  
  128. <Num  Lock> will produce the same effect as <Shift> Left or  Right  arrows.
  129.  
  130. Tag  all files using (Ctrl> RIGHT ARROW,  and un-tag all files with  <Ctrl>
  131. LEFT ARROW.
  132.  
  133. Pressing RETURN after selecting files will immediately begin the Play  mode
  134. and sound will start.  If you press Escape after making a selection(s), the
  135. selected files will be abandoned and you will be returned to the main menu.
  136.  
  137. Additionally, if you press RETURN without selecting any files, you will be
  138. returned to the main menu.
  139.  
  140. ----------
  141. SORT FILES:
  142. ----------
  143.  
  144. Sorting is easy, just pick a number (as follows):
  145.  
  146.     1 = Sort by filename.
  147.     2 = Sort by file size.
  148.     3 = Sort by file date.
  149.  
  150. -----------
  151. TOGGLE SAVE: ALT + S
  152. -----------
  153.  
  154. After selecting voice files from the File Selection Window, VT will ask you
  155. if you wish to save these sounds to disk so that you may replay them later.
  156. If you do not wish to be asked this question each tim you make  selections,
  157. then press "Alt+S" to turn the "Save-Request" question OFF.  You may toggle
  158. it ON or Off as desired.
  159.  
  160. If  the above command is "ON",  and you respond by pressing "Y"  (for  YES)
  161. when  asked to save your session,  a File Save/Retrieve screen will  prompt
  162. you for a filename for the session to be saved.   Enter a filename of up to
  163. 8 characters but do NOT include any file extension.   VT will automatically
  164. add an extension of ".SAV"  to all saved sessions.   You will be advised if
  165. the    file   already   exists   to   avoid   overwriting   other    files.
  166.  
  167. After the file has been successfully saved, your current selections will
  168. play immediately.
  169.  
  170. If you do not wish to save the current session, you may press "N" (NO), or
  171. simply press the ENTER KEY since "NO" is the default choice.
  172.  
  173. -------------
  174. LOAD SESSION: (ALT + L)
  175. -------------
  176.  
  177. To play a saved session,  start VT then press ESCape to exit from the  File
  178. Window,  then type ALT + L.   The File Save/Retrieve screen will prompt you
  179. for the name of the session you wish to load.   Enter an 8 character  name.
  180. Do not include an extension.
  181.  
  182. When  you  press  ALT + L,  VT will search the current  directory  for  the
  183. requested  file.   If the file is not found,  an error message will  advise
  184. you.   If the file IS found,  the sounds will be played without hesitation.
  185.  
  186. CAUTION: IF ANY OF THE FILES ARE MISSING, VOCTHING SHOULD BE ABLE TO HANDLE
  187. THE PROBLEM AND CONTINUE.  HOWEVER ANYTHING IS POSSIBLE,  SO IF THE PROGRAM
  188. STALLS,   CHECK  FOR  MISSING FILES.   IF VOCTHING IS ABLE  TO  HANDLE  THE
  189. FILENAME ERROR,  OBVIOUSLY YOU WILL NOT HEAR THE MISSING SELECTION(S),  BUT
  190. THE STATUS WINDOW WILL DISPLAY A "FILENAME MISSING"  MESSAGE AND PLAY  WILL
  191. CONTINUE WITH THE NEXT SELECTION IN THE QUEUE IF ANY.
  192.  
  193. IF YOU EDIT THE "XXXXXXXX.SAV"  FILE AND DELETE ANY ENTRIES,  YOU MUST ALSO
  194. CHANGE THE NUMBER COUNT AT THE TOP OF THE FILE TO MATCH THE NUMBER OF SOUND
  195. FILES.   IF THIS IS NOT DONE,  VOCTHING WILL CRASH AT SOME POINT.   EDITING
  196. THIS FILE IS NOT RECOMMENDED.
  197.  
  198.                          COMMANDS FOR PLAYING VOC FILES
  199.                          ------------------------------
  200. -------------
  201. PAUSE Command: (P)
  202. -------------
  203.  
  204. Pressing  "P"  will temporarily PAUSE the current sound.   While  PAUSE  is
  205. active,   the  CONTINUE command is highlighted and other commands  will  be
  206. visually de-emphasized.
  207.  
  208. NOTE:  Occasionally, when you select the PAUSE command, it may get stuck on
  209. a note that refuses to be silent.  If this happens, use the "C"  command to
  210. CONTINUE  and  then use the "P"  command again until the sound  fades  out.
  211.  
  212. ----------------
  213. CONTINUE Command: (C)
  214. ----------------
  215.  
  216. Pressing "C"  will CONTINUE a sound, or reverse a PAUSE command. Sound will
  217. resume playing from the point that it was PAUSED.
  218.  
  219. ------------
  220. SKIP Command: (S - or you may press the Spacebar)
  221. ------------
  222.  
  223. Pressing "S"  will terminate the current sound and will play the next sound
  224. in  the queue immediately.   You may also use this command to move  to  the
  225. next sound if the current file gets "stuck" or just stops playing (probably
  226. a corrupt file).  You  may also  press the SpaceBar to invoke this command.
  227.  
  228. The  term "skip"  in this instance means that the file was  aborted  during
  229. play   rather   than   actually  "skipped  over"    before   being   heard.
  230.  
  231. ---------------------------
  232. FILE WINDOW  [EXIT] Command: (F)
  233. ---------------------------
  234.  
  235. Pressing "F"  will terminate VT's Sound play  mode and return  you to   the
  236. FILE  SELECTION WINDOW where you may select more files to play or  exit  to
  237. the Main Menu.
  238.  
  239. ------------
  240. EXIT Command: (X - or you may press the Escape Key)
  241. ------------
  242.  
  243. Pressing "X"  or Escape will shut down VT's sound play mode and return  you
  244. to the main menu.   On the other hand,  when the last file has been played,
  245. VT will exit the Play Mode and return you to the main menu.   At that point
  246. the File Selection Window will pop-up automatically.
  247.  
  248. -------------------
  249. ENDING THE PROGRAM: (ESC - from main menu)
  250. -------------------
  251.  
  252.  
  253.  
  254.                          COMMANDS FOR RECORDING VOC FILES
  255.                          --------------------------------
  256.  
  257. ** NOTE:
  258.  
  259.    You may have to adjust your volume while in the RECORD MODE. Generally,
  260.    I have found that I have to increase the volume in order to properly
  261.    hear my recordings.  Good speakers and a decent microphone will increase
  262.    the quality of your recordings.  Ten seconds may not seem like a lot of
  263.    recording time however, sound files consume a lot of memory and can get
  264.    quite large very quickly.  The size of the buffer will be displayed during
  265.    "Playback" to let you know how large the resulting file will be if saved.
  266.    Increasing the time and the Sample Rate will increase the memory required
  267.    for the sound data. If VT locks up, then you are probably "Out of Memory"
  268.  
  269. --------------------
  270. RECORD MODE Command: ALT-R  Activate Record Mode
  271. --------------------
  272.  
  273. From the Main Menu:
  274.  
  275. Press ALT-R to active Record Mode.  You will be presented with the RECORDING
  276. Control Screen.  Follow these steps to record and replay a VOC file:
  277.  
  278.   1 - Upon entering record mode, the "S" (Seconds) will be flashing prompting
  279.       you to press "S" to enter the "Time Select" mode. However, if you wish
  280.       you may change the Sample Rate first by using the Up or Down Arrow keys
  281.       to increase or decrease the number of "Samples" used.*
  282.  
  283.       To set the number of seconds, press a number key representing the
  284.       number of seconds desired.  For instance, key number 4 would equal 4
  285.       seconds of recording time.  There is a 3 second minimum and a default
  286.       value of 10 seconds maximum.  You may press the ENTER KEY TO ACCEPT
  287.       THE DEFAULT, or press ONE number key (3 through 9) for a specific time.
  288.  
  289.   2 - You will be notified to turn on your microphone if you have not already
  290.       done so. The prompt will ask you to press ENTER to begin your recording
  291.       session.  Once you press the ENTER key, VOC THING will transmit all
  292.       sound from your microphone into a buffer for the selected number of
  293.       seconds determined in step 2 above.
  294.  
  295.   3 - Upon completion of the recording session, you will be asked if you want
  296.       to replay your recording to verify the content and quality.  You may
  297.       replay it as many times as desired.
  298.  
  299.   4 - After responding "N" (NO) to the Replay request, you will be asked if
  300.       you wish to save the sound data to a disk file. "N" will return
  301.       to the Record Mode.  "Y" will display a File Save/Retrieve screen
  302.       which will prompt you to enter an 8 character or less name for the
  303.       file.  Do not include any extension.  VT will automatically add an
  304.       extension of "VOC".  The message window at the bottom of the screen
  305.       will advise you if any situation occurs that requires your attention.
  306.  
  307.   5 - Before saving the new file, VT will append a file "Header" to the raw
  308.       digitized data to put the file in "official" VOC format.  There is no
  309.       need for you to use the VOC-HDR.EXE utility program that came with
  310.       your Sound Blaster.  Additionally, if you are a Windows 3.1 user, you
  311.       may be interested to know that .WAV files (Windows Sound Files) may
  312.       be converted to .VOC files and vise-versa.  Such Conversion programs
  313.       may be found on many Bulletin Boards or from various Shareware Vendors.
  314.       Of interest too is JOINTVOC for joining two or more voice files.  This
  315.       also came with your Sound Blaster.
  316.  
  317.       * See your Sound Blaster manual for more information on "Sampling" and
  318.         how it affects recordings.  The Sampling Rate may be increased or
  319.         decreased in increments of 100 to a maximum of 12000 Hz.  If you
  320.         use the maximum with a 10 second time duration, the resulting file
  321.         will be 120,000 bytes....about 1/3 the size of a standard 5 1/2"
  322.         floppy diskette.  That partially explains the 10 second limitation.
  323.  
  324. Press  "ESCape" to return to the main menu from the Record Mode.
  325.  
  326. Pressing ESCape from the main menu will terminate VT and return you to  the
  327. DOS  prompt (assuming the File Selection Window was not active).    If  the
  328. File Selection Window is active, pressing ESCape 3 times will terminate VT,
  329. and  return  you to the DOS prompt while displaying a  low key  shareware
  330. screen and session time.
  331.  
  332.  
  333.                             Version History
  334.  
  335.     Version 1.0  = August 1992 Initial Release.
  336.     Version 1.1  = Added Record Sound feature.
  337.                    Added File Save feature.
  338.  
  339.     ---------------------------------------------------------------------
  340.     Questions or problems? My direct FAX number is (516) 538-2633.
  341.  
  342.     The latest version of VT may be found on the following bulletin boards:
  343.     ---------------------------------------------------------------------
  344.                 1 -  The Executive Network BBS, New York
  345.                      914-667-4684 all baud speeds
  346.     ---------------------------------------------------------------------
  347.  
  348.                 2 -  The Invention Factory, New York
  349.                      212-431-1254
  350.  
  351.                 3 -  Digital Zero, New York
  352.                      212-353-8415
  353.  
  354.                 4 -  Computer Connection, Washington, D.C.
  355.                      202-543-8088
  356.  
  357.                 5  - Vernon Buerg's BBS, Calif.
  358.                      707-778-8944
  359.  
  360.                 6  - Gene Plant's BBS, Illinois
  361.                      708-843-8664
  362.  
  363.                 7  - The SoundBlaster Digest BBS, Toronto
  364.                      416-840-2485
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.